home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat1 / pmclient.z / pmclient
Text File  |  1997-04-03  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMCCCCLLLLIIIIEEEENNNNTTTT((((1111))))                                                        PPPPMMMMCCCCLLLLIIIIEEEENNNNTTTT((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmcccclllliiiieeeennnntttt - a simple performance metrics client
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppmmmmcccclllliiiieeeennnntttt [----ppppzzzz] [----aaaa _a_r_c_h_i_v_e] [----hhhh _h_o_s_t] [----nnnn _n_a_m_e_s_p_a_c_e] [----ssss _s_a_m_p_l_e_s] [----SSSS
  13.      _n_u_m_s_e_c] [----tttt _d_e_l_t_a] [----ZZZZ _t_i_m_e_z_o_n_e]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      ppppmmmmcccclllliiiieeeennnntttt is a simple client that uses the Performance Metrics Application
  17.      Programming Interface (PMAPI) to report some high-level system
  18.      performance metrics.
  19.  
  20.      The real value of ppppmmmmcccclllliiiieeeennnntttt is as a sample client using the PMAPI, and to
  21.      this end the source code is included in the _p_c_p._c_l_i_e_n_t._d_e_m_o subsystem of
  22.      the Performance Co-Pilot (PCP) product.
  23.  
  24.      By default, metrics are fetched from the local host, however if the ----hhhh
  25.      option is specified, then ppppmmmmcccclllliiiieeeennnntttt connects to ppppmmmmccccdddd(1) on _h_o_s_t and
  26.      fetches metrics from there.
  27.  
  28.      Alternatively, if the ----aaaa option is used, the metrics are retrieved from
  29.      the PCP archive log files identified by the base name _a_r_c_h_i_v_e.
  30.  
  31.      Using an archive implies a host name, and nominating a host precludes
  32.      using an archive, so the options ----aaaa and ----hhhh are mutually exclusive.
  33.  
  34.      Normally ppppmmmmcccclllliiiieeeennnntttt operates on the default Performance Metrics Namespace
  35.      (PMNS), however if the ----nnnn option is specified an alternative namespace is
  36.      loaded from the file _n_a_m_e_s_p_a_c_e.
  37.  
  38.      Use the ----tttt option to change the reporting interval to once every _d_e_l_t_a
  39.      seconds - the default is one every 5.0 seconds.
  40.  
  41.      If the ----ssss option is specified, _s_a_m_p_l_e_s defines the number of samples to
  42.      be retrieved and reported.  If _s_a_m_p_l_e_s is 0 or ----ssss is not specified,
  43.      ppppmmmmcccclllliiiieeeennnntttt will sample and report continuously - this is the default
  44.      behaviour.
  45.  
  46.      The output from ppppmmmmcccclllliiiieeeennnntttt is directed to standard output, and lists
  47.  
  48.      +  Aggregate CPU utilization, in the range 0 to 1.
  49.  
  50.      +  If the system has more than 1 CPU, the ordinal number of the busiest
  51.         CPU, in the range 0 to ...
  52.  
  53.      +  If the system has more than 1 CPU, the CPU utilization for the busiest
  54.         CPU.
  55.  
  56.      +  Real free memory in Mbytes.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMCCCCLLLLIIIIEEEENNNNTTTT((((1111))))                                                        PPPPMMMMCCCCLLLLIIIIEEEENNNNTTTT((((1111))))
  71.  
  72.  
  73.  
  74.      +  Aggregate physical disk I/O operations per second (IOPS).
  75.  
  76.      +  Load average over the last 1 minute and over the last 15 minutes.
  77.  
  78.      By default, ppppmmmmcccclllliiiieeeennnntttt reports the time of day according to the local
  79.      timezone on the system where ppppmmmmcccclllliiiieeeennnntttt is run.  The ----ZZZZ option changes the
  80.      timezone to _t_i_m_e_z_o_n_e in the format of the environment variable TTTTZZZZ as
  81.      described in eeeennnnvvvviiiirrrroooonnnn(5).  The ----zzzz option changes the timezone to the local
  82.      timezone at the host that is the source of the performance metrics, as
  83.      identifed via either the ----hhhh or ----aaaa options.
  84.  
  85.      The ----SSSS option may be used in conjunction with an archive to request that
  86.      display start at the time _n_u_m_s_e_c seconds from the start of the archive.
  87.      Also when using archives, the ----pppp option requests that the prevailing
  88.      real-time delay be applied between samples (see ----tttt) to effect a pause,
  89.      rather than the default behaviour of replaying at full speed.
  90.  
  91. FFFFIIIILLLLEEEESSSS
  92.      ////vvvvaaaarrrr////ppppccccpppp////ppppmmmmnnnnssss////*                   default PMNS specification files
  93.      ////vvvvaaaarrrr////ppppccccpppp////ddddeeeemmmmoooossss////ppppmmmmcccclllliiiieeeennnntttt           source code and Makefiles
  94.      ////vvvvaaaarrrr////ppppccccpppp////ccccoooonnnnffffiiiigggg////ppppmmmmllllooooggggggggeeeerrrr////ccccoooonnnnffffiiiigggg....ppppmmmmcccclllliiiieeeennnntttt
  95.                                        ppppmmmmllllooooggggggggeeeerrrr(1) configuration for creating
  96.                                        an archive suitable for replay with
  97.                                        ppppmmmmcccclllliiiieeeennnntttt
  98.  
  99. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  100.      ppppmmmmggggeeeennnnmmmmaaaapppp(1), ppppmmmmaaaappppiiii(3), ppppmmmmcccchhhhaaaarrrrtttt(1), ppppmmmmccccdddd(1), and ppppmmmmkkkkssssttttaaaatttt(1).
  101.  
  102. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  103.      All are generated on standard error, and are intended to be self-
  104.      explanatory.
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.